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This paper gives an overview of the Edapt solution to the GMF model migration case [2| of the 
Transformation Tool Contest 2011. 



1 Edapt in a Nutshell 

EdapQ is a transformation tool tailored for the migration of models in response to metamodel adaptation. 
Edapt is an official Eclipse tool derived from the research prototype COPE. 

Modeling the Coupled Evolution. As depicted by Figure [TJ Edapt specifies the metamodel adaptation 
as a sequence of operations in an explicit history model. The operations can be enriched with instruc- 
tions for model migration to form so-called coupled operations. Edapt provides two kinds of coupled 
operations according to the automatability of the model migration [6]: reusable and custom coupled 
operations. 
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Figure 1 : Overview of Edapt 



Reuse of recurring migration specifications allows to reduce the effort associated with building a 
model migration H. Edapt thus provides reusable coupled operations which make metamodel adap- 
tation and model migration independent of the specific metamodel through parameters and constraints 
restricting the applicability of the operation. An example for a reusable coupled operation is Enumeration 
to Sub Classes which replaces an enumeration attribute with subclasses for each literal of the enumer- 
ation. Currently, Edapt comes with a library of over 60 reusable coupled operations [8]. By means of 
studying real-life metamodel histories, we have shown that, in practice, most of the coupled evolution 
can be covered by reusable coupled operations HE). 

'http : //www. eclipse . org/edapt 
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platform:/resource/libraryv mcclel/library.eeore 
library 
§ Library 
g Book 

f title: EString 
pages : EInt 

category : BookCategory 

author : Writer 
1? BookCategory 
R Writer 



jfjl pi atf o rm :/f eso u re e.'1ibrary/mo del/library, history 
3 History 

J5 Release (05.01.2011 03:19:30] 
J5 Releasev2(Q5.Gl,2011 08:23:25) 

(f Operation ' Delete Feature" ha: been executed (feature - {n3 Fie) 

$j Operation "Sub Classes to Enumeration" has been executed (contextClass = {Book}, attrib 
— Custom Migration "library.util.WriterCustomMigration" has been attached 

Operation "Create Class" has been executed (ePackage = {library}, name = "Writer", su 
Operation "Create Reference" has been executed (eClass - {Library}, name - "writers", 
ffl {name} has been moved from {Book} to {Writer} 

Operation "Rename" has been executed (element - {name}, name - "name"] 
Operation "Create Reference" has been executed (eClass = {Book}, name = "author", b, 
:= nsURI of {library} has been changed from "http://l i b ra ry/vl " to "http :,.'?! i bra ry/V2" 
JjJ Release (not yet released) 



r 
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9 public class WriterCustorcMigration extends CustorcMigration { 

10 

11 private EAt tribute author At tribute ; 

@ Override 

public void rcigrateBef ore (Model model, Metairodel rr.et-arr.odel) 
throws MigrationExceptian { 
author At tribute = metarcodel . getEAttribute ( rr library . BooJi - 

J 

^Override 

public void rcigrateAf ter (Model rr.odel f Metarr.odel rr.etarc.odel) 
throws MigrationException { 
for (Instance book : rcodel . getAHInstances ( "library . 3oc 
String author = book. unset (authcrAttribute) ; 

Instance library = book ■ getContai ner t \ ; 

< | rrr | 



£o} Operation Browser - library.ecore \ 1=1 H 
Create History Release Converge 



Applicable Operations 
Move Classifier 
Remove SuperType 
Remove Superfluous SuperType 
Rename 
; : ; C : 
{g3 Specialize Super Type 



{J@ Sub Classes 1c Enumeration 
Unfold Superclass 



Name 

|r.i| contextClass 
attributeName 

(^ ePackage 
enumName 



Value 
g Book 

library 



Violated constraints: 



© Parameter 'attributeName' must be set 
© Parameter 'enumName' must be set 
© The context class must have sub types 
G The context class must be abstract 



LJ Change Documentation 
Operation "Sub Classes to Enumeration" 

In the metamodel, the subclasses of a class are 
replaced by an enumeration. An enumeration 
with literals for all subclasses is created and an 
enumeration attribute is created in the class. 
Finally, all subclasses are deleted, and the class is 
made concrete. In the model, instances of a 
subclass are migrated to the class, setting the 
enumeration attribute to the appropriate literal. 

• contextClass: The context class 

• attributeName: The name of the 
enumeration attribute 



Figure 2: User interface of Edapt 



Migration specifications can become so specific to a certain metamodel that reuse does not make sen- 
se 13). To express these complex migrations, Edapt allows the user to define a custom coupled operation 
by manually encoding a model migration for a metamodel adaptation in a Turing-complete language 0. 
By softening the conformance of the model to the metamodel within a coupled operation, both meta- 
model adaptation and model migration can be specified as in-place transformations, requiring only to 
specify the difference. A transaction mechanism ensures conformance at the boundaries of the coupled 
operation. 

Recording the Coupled Evolution. To not lose the intention behind the metamodel adaptation, Edapt 
is intended to be used already when adapting the metamodel. Therefore, Edapt's user interface, which is 
depicted in Figure |2j is directly integrated into the existing EMF metamodel editor. The user interface 
provides access to the history model in which Edapt records the sequence of coupled operations. An 
initial history can be created for an existing metamodel by invoking Create History in the operation 
browser which also allows the user to Release the metamodel. 

The user can adapt the metamodel by applying reusable coupled operations through the operation 
browser. The operation browser allows to set the parameters of a reusable coupled operation, and gives 
feedback on the operation's applicability based on the constraints. When a reusable coupled operation 
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is executed, its application is automatically recorded in the history model. Figure [2] shows the operation 
Sub Classes to Enumeration being selected in the operation browser and recorded to the history model. 

The user needs to perform a custom coupled operation only, in case no reusable coupled operation 
is available for the change at hand. First, the metamodel is directly adapted in the metamodel editor, 
in response to which the changes are automatically recorded in the history. A migration can later be 
attached to the sequence of metamodel changes. Figure [2] shows the migration editor to encode the 
custom migration in Java. 



2 GMF Model Migration Case 

The complete solution is available through a SHARE demo [3 ] and in the repository of the Eclipse Edapt 
projecj^] Here, we only briefly describe the main characteristics of the solution. 

Core Task. To build the history model for the GMF Graph metamodel, we took the intermediate meta- 
model versions from the case resources and applied coupled operations to get from one metamodel ver- 
sion to the next. To know which coupled operations to apply, we used the difference model obtained with 
EMF Compard^between two subsequent metamodel versions. Edapt provides the so-called Convergence 
View which automatically updates the difference model after each application of an operation fTl . 

Table [T] lists the employed coupled operations together with their number of applications. Most of 
the evolution can be covered by reusable coupled operations. For more information about the reusable 



coupled operations, we refer the reader to 00. Section A.l of the appendix shows the screenshot of 
the history model from release 1.0 to 2.1. The history model also contains markers for the different 
metamodel versions. Only two custom coupled operations are necessary to specify a correct model 
migration. The first custom migration is necessary to initialize a reference that was made mandatory. The 
second custom migration decouples the diagram elements from the figures to make the figures reusable. 



The custom migrations which are implemented in Java can be found in Sections A.3 and A.4 of the 
appendix of this paper. 

Multi-File Models. Edapt can migrate multi-file models, as it preserves the modularization into files 
throughout the migration. If one file refers to the other, the second file is automatically loaded when 
resolving references. However, a user can also explicitly define that several files are migrated together. 

GMF Map metamodel. To build the history model for the GMF Map metamodel, we applied the same 
procedure as in case of the GMF Graph metamodel. Table [2] lists the employed coupled operations 
together with their number of applications. The complete coupled evolution can be covered by reusable 
coupled operations. For more information about the reusable coupled operations, we refer the reader to 
i8l . The screenshots of the resulting history model are depicted in Section A.2 of the appendix: One 



screenshot shows the coupled operations from release 1.0 to 2.0, and another one the operations from 
release 2.0 to 2.1. 

As one can see, the history model is modularized into different releases. Based on the namespace 
URI, Edapt automatically detects of which release a model is and applies the coupled operations from 
this release to the newest release. Moreover, the history model can be recorded for metamodels that refer 
to other metamodels. However, to be able to load the models, the other metamodels need to be available 
during migration. In the solution, we ensured this by starting the migration in an Eclipse workbench 
where the other metamodels are available through plugins. 



http : //dev . eclipse . org/svnroot/modeling/org. eclipse . emf t . edapt /trunk/examples/ttc_gmf 



http : //www. eclipse . org/emf /compare/ 



30 Solving the TTC 201 1 Model Migration Case with Edapt 



Table 1: GMF Graph 



Operation 


Kind 


Number 


AHH Sinner Tvnp 


Rpusahlp 

LI J CC 1 / 1 C^ 


10 


C'hanpp Namesnace TIRT 


Reusable 

LI . ' CC 1 / 1 C_ 


1 


("Yeafe Attrihntp 


Rpusahlp 


2 


Create Class 


Reusable 


4 


Create Reference 


Reusable 


5 


l~)plpfp ppatnrp 


Rpusahlp 


4 


Dplpfp Onpratinn 


Rpusahlp 


1 


Document Metamodel Element 


Reusable 


12 


l~)ron Attribute THpntifipr 

l--' 1 V / VJ iiLll 1 L.' LI I L- 1 L1L- 1 1 1 1 1 1 L* 1 


Rpusahlp 

1\L LI . > CC I / 1 C_ 


1 


Extract Super Class 


Reusable 


3 


Generalize Attribute 


Reusable 


1 


Generalize Reference 


Reusable 


1 


Inline Super Class 


Reusable 


2 


N4ake Class Abstract when Interface 


Reusable 


14 


Make Reference Containment 


Reusable 


1 


Not Changeable to Suppressed Set Visibility 


Reusable 


1 


Push Down Feature 


Reusable 


4 


Remove Super Type 


Reusable 


10 


Specialize Reference Type 


Reusable 


4 


Specialize Super Type 


Reusable 


6 


Suppressed Set Visibility to Not Changeable 


Reusable 


1 


Unfold Super Class 


Reusable 


1 


Initialize FigureAccessor.typedFigure 


Custom 


1 


Decouple FigureHandle.referencingElements 


Custom 


1 



3 Conclusion 

Expressiveness. The language provided by Edapt is expressive enough to specify the migration. Most 
of the migration can be covered by reusable coupled operations. For more complex migrations, custom 
coupled operations can be specified in Java. The API provided to specify the custom coupled opera- 
tions turned out to be expressive enough to cover the complex migrations involved in the GMF Graph 
metamodel evolution. 

Correctness. To ensure correctness, we used the test models from the case resources. We modified the 
history model until there are no differences between the migrated model and the expected model. To 
obtain the differences, we used EMF Compare. We ignored differences in the order of references, since 
we believe that the order is not important for the GMF Graph and Map models. 

Conciseness. The migration specification is rather concise, since most of the evolution can be covered by 
reusable coupled operations. Only two custom coupled operations are required: one with 21 and another 
one with 90 lines of custom migration code. Considering the complexity of the second migration, we 
consider the migration specification as concise. However, conciseness could be improved by providing 
a DSL instead of a Java API to implement migrations. 

Maintainability. The history model is easy to understand, since it is modularized into rather small 
coupled operations. Intermediate metamodel versions can be reconstructed from the history model, thus 
simulating the evolution. Moreover, coupled operations can be undone to revert changes that have been 
performed erroneously, and custom migrations can be removed, edited and added to fix error-prone 
migrations. Finally, existing history models can be extended by recording new coupled operations that 
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Table 2: GMF Map 



Operation 


Kind 


Number 


Change GMF Constraint 


Reusable 


5 


Chantrp Namp^narp TTRT 


Rpnsahlp 

l\v \AjCL\JWj 


3 


Crpatp Annotation 

V 1 LtUV, illlllU LclLlwll 


Rpnsahlp 


1 


Create Attribute 


Reusable 


3 


Crpatp Class 


Rpnsahlp 


2 


Crpatp Fnnmpration 


Rpnsahlp 


3 


Crpate GMF Constraint 

V 1 LlUV, V J 1V11 V-'UlljLl Lllll L 


Rpnsahlp 


6 


Crpatp Rpfprpnpp 

V 1 LtUV, IVwlCl ^ 1 1\- 


Rpnsahlp 


3 


Delete Annotation 


Reusable 


2 


l~)nnimpnt A/Tptfimnrlpl Plpmpnt 

L yy. LI 1 1 1L_ 1 1 1 1 V 1L l til 1 IWL-LL. 1 J ill-lllL~lll 


Rpnsahlp 

1 VL_ LL . 1 1 1 Li 1 L_ 


12 


Extract Subclass 


Reusable 


1 


Extract Super Class 


Reusable 


1 


Inheritance to Delegation 


Reusable 


1 


Make Class Abstract when Interface 


Reusable 


10 


Make Feature Volatile 


Reusable 


1 


Move Annotation 


Reusable 


1 


Not Changeable to Suppressed Set Visibility 


Reusable 


5 


Push down Feature 


Reusable 


2 


Replace Enumeration 


Reusable 


2 


Suppressed Set Visibility to Not Changeable 


Reusable 


5 



are applied to the metamodel. 
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A Solution 

A.l GMF Graph History 



JT| Releasel.O (08.02.200912:16:45) 
d JT1 Release 2.1 (08.02.200919:53:06) 

Operation "Create Class" ha;:- beer executed (ePackage - {gmfgraphj, name - "ScalablePolygcn", superclasses - [(Polygon}], abstr - false] 

Operation Document [■.■let sine del Element" has. been executed (element - {ScalablePolygon}, documentation - "Marker interface to denote polygons with ability to 
= Wo Change 1.24 

Cpersticn Create -ttribute" ha: been executed (eClass = {Node}, name = " affixed P a rentSide", type = {Direction}, lowerBound = 0, upperBound = 1, defaultValue = " 
= Wo Change 1.25 

■ Operation "Create Class" has been executed (ePackage - (gmfgraphj, name - "DefaultSizeFaeet", superclasses - [{Visual Facet J], abstr - false) 

: ' Operaticn "Create Reference" has been executed 'eClass = {DefaultSizeFaeet}, name = "defaultSize", type = {Dimension}, lowerBound = 0, upperBound = 1, contains 

= WoChangel26 
■■ ^ Composite Change 

= N.o Change 127 
. ^ Composite Change 

= WoChangel.28 
:■ ^| Composite Change 

= Wo Change 129 

Cpersticn Extract Super Class" has been executed (sub-Class - {Node}, toExtract - [J, ePackage - (gmfgraphj, superClassNarne - "AbstractNode", abstr - true, supei 
[> Operation "Extract Super Class" has been executed (subclass - {ConnectionFigure}, toExtract - [], ePackage - {gmfgraph}, superClassWame = "RealFigure", abstr = ti 
Cpersticn specie \ze Super Type" has been eseculed (eClass = {DeccraticnFigure}, toReplace = (Figure], replaceBy = (RealFigure}) 

> Operation "Specia ize Super Type" has been executed (eClass - (Shape), toReplace - (Figure}, replaceBy - (RealFigure}] 
:> Operation "Specia ize Super Type" has been executed (eClass = {Label}, toReplace = (Figure}, replaceBy = {RealFigure}] 

■ Operation "Specia ize Super Type" has been executed (eClass - {LabeledContainer}, toReplace - (Figure;.. replaceBy - (PealFigureJ) 

Cpersticn "Specia ice Super Type" has been executed (eClass - (CustomFigureJ, toReplace - {Figure}, replaceBy - (RealFigure}] 
f'" Operaticn "Document Heta model Element" has been executed (element - {RealFigure}, documentation - "This is exact specific concrete figure, unlike proxy refere 
Operaticn "Extract Super Class" has been executed ■ subCIss; - {ReelFigureJ, toExtract - [], ePackage - (gmfgraphj, superClassNarne - 'AbstractFigure", abstr - true, 
Cpersticn "Document Meta model Element" has been executed (element = {AbstractFigure}, documentation = "This is merely an implementation artifact to get only 
Operation "Push down Feature" has been executed (feature - {children}] 

■ Operation "Push down Feature" has been executed (feature - {children}] 

Operation "Unfold Superclass" has been executed (subclass = {Figure}, superclass = {Identity}) 
l> Operation "Push down Feature" has been executed (feature- {name}] 

■ Operation "Push down Feature" has been executed (feature -{name}] 

> Operation "Generalize Attribute" has been executed (attribute - {name}, lowerBound - null, upperBound - 1] 
:= iD of {name} has been changed from true to false 

f"' Operaticn "Specialise Reference Type" has been executed (reference - {figure}, type - {AbstractFigure}] 

Operation "Specialize ReferenceType" has been executed (reference - {figure}, type - {RealFigure}] 
•T Operaticn "Document Meta model Element" ha: been executed (element = {figure}, documentation = "net just Figure because don't want to reference figure referen 
Cpersticn Specialise Reference T pe hss been executed (reference - {figures}, type - {AbstractFigure}) 
i Operaticn 'Specialize Reference Type" has been executed (reference - {figure; !■, t-.pe - {RealFigure}] 

f"' Operaticn "Specialize Super Type" has been executed (eClass = {FigureRef}, toReplace = (FigureMarkerJ. replsceR. = {AbstractFigure}) 
l> Operation "Inline Super Class" has been executed [superclass = {FigureMarker}] 
Cpersticn Delete Feature hss been executed (feature - (parent;: 

Cpersticn Document Meta model Element" has been executed (element - {Figure}, documentation - "An- thing cu could combine visual representation from. Ore 
Cpersticn 'Document Metamcdel Element" has been executed (element - {customChildrenJ, documentation - "Childrent enumerated with thisfeature are mere 'at 
■. U EAttribute{externalJ has been created in {DiagramLabel} 

Cpersticn "Delete Feature" has been executed (feature - {nodeFigure}) 

r> Operation "Delete Feature" has been executed (feature = (connectionFigure}] 

[> Operation "Delete Feature" has been executed (feature - {bundleName}] 

> |X| EOperation {find} has been deleted from (Diagram Element} 

. Operation ' Generalize Reference" has been executed (reference - {typedFigureJ, type - {RealFigure}, lowerBound - 0, upperBound - 1] 
l> Operation "Make Reference Containment" has been executed (reference - {typedFigure}) 
a Custom Migration "GMFGraphTypedFigureCustomMigration" has been attached 

:= lowerBound of {typedFigure} has been changed from to 1 
j 5]S Custom Migration "GMFGi ap lF eC esc ipto C jsto n Migration" has been attached 
■ ^| Composite Change 

> |+| EReference {accessor} has been created in {Compartment} 
[+] EKeference{accessor} has been created in {DiagramLabel} 
■, |+| EReference{contentPaneJ has been created in {Node} 

: [+j EReference {descriptors} has been created in {FigureGallery} 

> [+] EReference{descriptor} has been created in {Figure} 

1+1 EReference {container} has been created in {DiagramLabel} 
: [X] EReference {referencingElements} has been deleted from {FigureHandle} 
:= eType of {figure} has been changed from (FigureHandle} to {FigureDescriptor} 
f'" Operation "Inline Super Class" has been executed (superclass - (FigureHandle}) 

:= nsURI of {gmfgraphj has been changed from "http://www.eclipse.org/gmf/2005/GraphicalDefinition" to "http://www.eclipse.org/gmf/2006/GraphicalDefinition" 
= No Changel.30 

Cpersticn Hot Chsngesble to Suppressed Set visibility" has been executed (reference = {owner}] 
™ resolve Proxies of {owner} has been changed from true to false 
= No Change 131 

Cpersticn Suppressed Set ", isibility to Hot Changeable" has been executed (reference - {owner}] 
= WoChangel.32 

■ Operation 'Create Class" has been executed (ePackage - {gmfgraph}, name - "BorderRef", superclasses - [{BorderJJ, abstr - false) 

Operation Document Metamcdel Element" has been executed (element - {BorderRef}. documentation - "Border reuse mechanism") 
l> Operation 'Create Reference" has been executed (eClass = {BorderRef}, name: "actual", type = {Border}, lowerBound = 1, upperBound = 1, containment = false, opj 

■ Operation 'Document Metamcdel Element" has been executed (element - {actual}, documentation - "constraint: actual should not be another BorderRef") 
. Operation Create Class" has been executed (ePackage - {gmfgraphj, name - "LayoutRef", superclasses - [{Layout}], abstr - false) 

. Operation 'Document Metamodel Element" has been executed (element = {LayoutRef}, documentation = "Layout reuse mechanism") 

Cpersticn Create Reference" has been executed (eClass - {LayoutRef}, name - "actual", type - {Layout}, Ic/. ei Bound - 1, upperBound - 1, containment - false, op 
Cpersticn Document Metamcdel Element" has been executed (element - {actual}, documentation - "constraint: actual should not be another LayoutRef") 
|> Operation 'Create Reference" has been executed (eClass = (FigureGallery}, name = "borders", type = {Border}, lowerBound = 0, upperBound = -1, containment = trui 
Cpersticn Document Metamodel Element" has been executed (element - {borders}, documentation - "Borders for reuse") 

Operaticn Create Reference" has been executed (eClass - {FigureGallery}, name - "layouts", type - {Layout}, lowerBound - 0, upperBound - -1, containment - true 
<T Operaticn 'Document Met = ■ ■ :■ :i= z . . hss been executed 'element - {layouts}, documentation - "Layouts for reuse"] 
= No.Changel.33 
JT] Release(notyet released) 
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■ jTJ Release 1.0 (03.02.2009 23:34:41) 
j JTJ Release2.0 (10.02.200900:03:13) 

t- Operation "Create GMF Constraint" has been executed [element = {Child Reference}, ocl = "let child:NcdeMapping=(rf ownedChild.oclIsUndefinedQ then referent 
l> Operation "Create GMF Constraint" has been executed [element = [C-hildReference}, ocl = "let child:NodeMapping=[if ownedChild.oclIsUndefinedO then referent 

= No Changel.44 

j^l Composite Change 

= NoChangel.45 

Operation "Ertract Super Clsss" ha: been executed 'subclass = {FeatureValueSpecJ, tcExtract = [{feature}, {featureSeqlnitializer}], ePackage = {mappings}, superCli 
:= interface of {Featurelnitializer] has been changed from false to true 
:= changeable of {featureSeqlnitializer] has been changed from true to false 

(r Operation "Create GMF Constraint" has been executed (element = (feature!, ocl = "feature = > null implies feat ure.eCcntainingCI ass, isSuperTypeOf(featureSeqInit 

■ Operation "Create GMF Constraint" has been executed (element - {feature}, ocl - "feature <> null implies feature.changeable", description - "The 'feature' of 'Fe 
:= value of{ocl -> feature <> null implies notfeatureSeqInitiali^er,initialirers->exists(i| i <> self and i, feature- self. feature)} has been changed from "feature.eContai 
:= value of {description -> The feature is already initialized by another 'Featurelnitializer' in the sequence} has been changed from "Initialized 'Feature' must be owne 

Operation "Document Met a mod el Element" has been executed (element - {feature), documentation - "The feature for which is to be initialized by this initializer" 
:> [Xj EAnnotation [meta] has been deleted from [feature] 

- Operation "Create Class" has been executed (ePackage - {mappings}, name - "ReferenceNewElementSpec", superclasses - [!'F^ : : .. - - . - ' ..• - : j ss 
'!r' Operation "Create Reference" has been executed (eClass = {Feature Seqlnitializer], name = "creatintilniiializer ' i- pe = {Referencel-Je/- Element Spec } lowerBound = 
™ changeable of {creatinglnitializer} has been changed from true to false 

Operation "Create GMF Constraint" has been executed ■ e e r •-. - [Fefeiencel-lewElementSpec}, ocl - "feature.many - false implies not [ne-.\ Element Enitiali-ei s--- 
■T/j Operation "Create GMF Constraint" has been executed (element = {ReferenceNewElementSpec}, ocl = "let r: ecore::EReference = feature.oclAsType(ecore::ERefere 
*f Operation "Create Reference" has been executed (eClass. - {ReferenceNewElementSpec], name - "newElementlnitializers ", type - {FeatureSeqlnitializer], lowerBou 
^1 Composite Change 

■ [+j EReference {elementClass} has been created in [FeatureSeqlnitializer] 

Operation "Create GMF Constraint" has been executed (element = {elementClass}, ocl = "not creatinglnitialiier.feature.ee HsUndefined' i implies ci eatinglnitializer," 
H Operation "Create GMF Constraint" has been executed (element - {elementClass}, ocl - "not creatinglnitializer.feature.cclIsUndefinedQ implies not (elementClass 
Operation "Document Metamodel Element" has been executed (element - {FeatureSeqlnitializer}, documentation - "Feature sequence initializerto initialize a seq 
Operation Make Feature volatile' has been executed 'feature = {mappingEntry], trans = true, derived = false, changeable = false) 
^3 Composite Change 

f' Operation ' Document Metamodel Element' has been executed 'element - {mappingEntry], documentation - "The 'MappingEntry' whose domain model elemer 
:= nsURI of {mappings} has been changed from "http://wiArw.eclipse.org/gmf/2005/mappings" to "http://www.eclipse.Org/gmf/2005/mappings/2.0" 
= No Changel.46 

fr Operation "Create Reference" has been executed (eClass - [i '= - - • :;Entr. ;• name - "relatedDi m; ~- ~: t :e - [Can- asMapping} lowerBound - 0, upperBcund - 
C Operation "Document Metamodel Element" has been executed 'element - {relatedDia grams}, documentation - "Diagrams that may be associated with this diagr 
= NoChangel.47 

:= value of {ocl -> feature <> null implies not featureSeqlniti alizer, initializers- =-exists(i| i <> self and i, feature - self/feature)} has been changed from "feature <> null 
= No Change 1.48 

■ Operation 'Extract Subclass" has been executed (superclass = {LabelMapping}, feature = {features}, className = "FeatureLabelMapping") 

Operation 'Push down Feature' has been executed (feature = {viewPattern}) 
[> Operation 'Push down Feature" has been executed (feature = {editPattern}) 

Operation "Document Metamodel Element" has been executed (element - {FeatureLabelMapping], documentation - "Label based on feature(s) from domain mt 
: '' Operation "Document Metamodel Element" has been executed (element = {viewPattern], documentation = "Pattern forjava.text.MessageFormat to produce labe 
& Operation Document Metamodel Element" has been executed (element - {LabelMapping], documentation - "Label definition; text is taken from thegraph mod 

Operation 'Create Class" has been executed (ePackage - {mappings}, name - "DesignLabelMapping", superclasses - [{LabelMapping}].. abstr - false) 

Operation 'Document Metamodel Element" has been executed (element = •;; :; ■ _ : s .' ; : : - :; documentation = "Label based on DescriptionStyle from notal 
= NoChangel.49 
J*\ Composite Change 
= NoChangel.5Q 

c- Operation "Create Enumeration" has been executed (ePackage = [mappings}, name = "LabelEditMethod", literals = ["MESSAGE. FORMAT", "REG EXP", "NATIVE"]) 
f Operation "Create Enumeration" has been executed (ePackage = [mappings}, name = "LabelViewMethod", literals = ["MESSAGE. FORMAT", "PRINTF", "NATIVE"]) 
t- Operation "Create Attribute" has been executed (eClass - {FeatureLabelMapping], name - "editMethod", type - {LabelEditMethod], lowerBound - 0, upperBount 
Operation "Create Attribute" has been executed (eClass = {FeatureLabelMapping} name = "viewMethod". type = {Label'.'ie>,-. Method !■ lowerBound = 0, upperBou 
(r Operation "Document Metamc ie 1 ernent" has been executed (element - {viewPattern}, documentation - "Pattern to produce label on diagram, depends on vie 
Operation "Document Metamodel Element" has been executed (element - {editPattern}, documentation - "Pattern to produce text for in place editor, depends or 
= NoChangel.51 

Operation "Create Enumeration ha: been executed (ePackage - {mappings}, name - "LabelTextAceessPvlethod", literals - ["PvlESSAGE.FQRMAT", "NATIVE", "REG 
r, Operation "Replace Enumeration" has been executed (toReplace = {LabelEditMethod}, replaceEy = {LabelTextAccessMethod], IrteralsToReplace = [{MESSAGE_FOF 
C- Operation "Replace Enumeration" has been executed (toReplace = [Label ViewMethod}, replaceBy = [LabelTextAccessMethod], literalsToReplace = [[MESSAGE_FO 
= Mo Chan gel 52 

[> Operation "Create Attribute" has been executed (eClass - {FeatureLabelMapping}, name - "editorPattem", type - {EString}, lowerBound - 0, upperBound - 1, def 
C Operation "Document Metamodel Element" has been executed (element - {editorPattem}, documentation - "Pattern to produce text for inplace editor, depends 
Operation "Document Metamodel Element" has been executed (element = {editPattern}, documentation = "Pattern to extract values from input text, depends on 
= NoChangel.53 

:= nsURI of {mappings} has been changed from "http://www.eclipse.Org/gmf/2005/mappings/2.0" to "http://www.eclipse.org/gmf/2006/mappings" 
E No Changel.54 

a JTJ Release 2.1 [10 .02.2005 00:07:59] 

Operation Not Changeable to Suppressed !;et Visibility has been executed (reference - {parentNode}) 

C :e -X'c '■ ' . C ■■- - s ;c S : essed Set Visibility "" ha: been executed 'reference = {featureSeqlnitializer}) 
i|T Operation "Not Changeable to Suppressed Set Visibility" has been executed (reference - {linlcMapping}) 
Operation "Not Changeable to Suppressed Set Visibility" has been executed (reference = {mapEntry}) 

> Operation "Not Changeable to Suppressed 1-et '.-'isibility' has been executed (reference - {creatinglnitializer}) 
[■> ^\ Composite Change 

= NoChangel.55 

:= interface of {Featurelnitializer} has been changed from true to false 

> Operation "Inherftanceto Delegation" has been executed (subclass - {FeatureValueSpec}, superclass - {ValueExpression}, referenceName - "value") 
[> ^\ Composite Change 

= NoChangel.56 

:= nsURI of {mappings} has been changed from "http://www.ecl ip-se.org/gmf/2006/mappings" to "http://www.eclip:e,ci , g-cinif jOOS -mappings" 
= No Changel.57 

(r Operation "Suppressed Set Visibility to Not Changeable" has been executed (reference - {parentNode}) 

Operation "Suppressed Set Visibilit. to Not Changeable" has been executed (reference = {featureSeqlnitializer}) 
Operation "Suppre::ed Set Visibility to Mot Changeable" has been executed (reference - {linkMapping}) 
Operation "Suppre::ed Set visibilit yto Net Changeable" has been executed (reference = {mapEntry}) 

■ Operation "Suppressed L'ei Visibility ic Net Changeable" has been executed ■ reference - {creatinglnitializer}) 
= NoChangel.58 
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Solving the TTC 201 1 Model Migration Case with Edapt 



A.3 Initialize FigureAccessor.typedFigure 

1 import org . eclipse . emf . edapt . migration . CustomMigration; 

2 import org . eclipse . emf . edapt . migration . Instance; 

3 import org . eclipse . emf . edapt . migration .Metamodel ; 

4 import org . eclipse . emf . edapt . migration . Model ; 

5 

6 public class GMFGraphTypedFigureCustomMigration extends CustomMigration { 



7 

8 @Override 

9 public void migrateAfter (Model model, Metamodel metamodel) { 

10 for (Instance fa : model . getAHInstances ( "gmf graph . FigureAccessor " ) ) { 

11 Instance tf = f a . getLink ( "typedFigure" ) ; 

12 if (tf == null) { 

13 tf = model . newlnstance ( "gmf graph . CustomFigure" ) ; 

14 t f . set ( "qualif iedClassName " , "org . eclipse . draw2d . I Figure" ) ; 

15 fa . set ( "typedFigure" , tf ) ; 

16 } else { 

17 tf . set ( "name" , null); 
} 

19 } 

20 } 



21 } 



A.4 Decouple FigureHandle.referencingElements 

i import java . util . List ; 
2 

3 import org . eclipse . emf . ecore . EReference ; 

4 import org . eclipse . emf . edapt . migration . CustomMigration; 

5 import org . eclipse . emf . edapt . migration . Instance; 

6 import org . eclipse . emf . edapt . migration .Metamodel ; 

7 import org . eclipse . emf . edapt . migration .MigrationException; 

8 import org . eclipse . emf . edapt . migration .Model ; 
9 

10 public class GMFGraphFigureDescriptorCustomMigration extends CustomMigration { 



11 

12 private EReference reference; 
13 

14 @Override 

15 public void migrateBef ore (Model model, Metamodel metamodel) 

16 throws MigrationException { 

17 reference = metamodel 

18 . get EReference ( "gmf graph . FigureHandle . ref erencingElement s " ) ; 

« } 

20 

21 @Override 

22 public void migrateAfter (Model model, Metamodel metamodel) 

23 throws MigrationException { 

24 for (Instance handle : model . getAll Instances ( "gmf graph . FigureHandle" ) ) { 

25 List<Instance> elements = handle . unset ( ref erence) ; 

26 if (! elements . isEmpty () ) { 

27 Instance toplevel = getToplevel (handle ) ; 

28 Instance descriptor = getOrCreateDescriptor (toplevel , model); 

29 for (Instance element : elements) { 

30 element . set ( "figure" , descriptor); 
} 

32 if (toplevel != handle) { 

33 Instance access = getOrCreateAccess (descriptor, handle) ; 

34 for (Instance element : elements) { 

35 if (element . instanceOf ( "gmf graph . DiagramLabel " ) 

36 | element . instanceOf ( "gmf graph . Compartment ") ) { 

37 element . set ( "accessor " , access); 
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38 } 

39 } 

40 } 
} 

} 

} 

44 

45 public Instance getToplevel (Instance handle) { 

46 while (handle . getContainer (). instanceOf ( "gmf graph . FigureHandle ") ) { 

47 handle = handle . getContainer () ; 

48 } 

49 return handle; 
} 

51 

52 public Instance getOrCreateDescriptor ( Instance toplevel, Model model) { 

53 Instance gallery = toplevel . getContainer () ; 

54 if (gallery . instanceOf ( "gmf graph . FigureDescriptor ") ) { 

55 return gallery; 
} 

57 Instance descriptor = model . newlnstance ( "gmf graph . FigureDescriptor" ) ; 

58 descriptor . set ( " actualFigure" , toplevel ) ; 

59 gallery . remove ( " figures " , toplevel ) ; 

60 gallery . add ( "descriptors " , descriptor) ; 

61 descriptor . set ( "name " , toplevel . get ( "name" ) ) ; 

62 return descriptor; 

63 } 
64 

65 public Instance getOrCreateAccess ( Instance descriptor, Instance handle) { 

66 Instance figure = null; 

67 if (handle . instanceOf ( "gmf graph . FigureAccessor" ) ) { 

68 figure = handle . getLink ( "typedFigure" ) ; 

69 } else { 

70 figure = handle; 
} 

72 Instance access = findAccess (descriptor , figure); 

73 if (access == null) { 

74 access = descriptor . getType ( ) .getModelO 

75 .newlnstance(" gmf graph . ChildAccess " ) ; 

76 access . set (" figure " , figure); 

77 descriptor . add ( "accessors" , access); 

78 } 

79 return access; 

80 } 
81 

82 public Instance findAccess (Instance descriptor, Instance figure) { 

83 for (Instance access : descriptor . getLinks ( "accessors" ) ) { 

84 if (access . get (" figure" ) == figure) { 

85 return access; 

86 } 

87 } 

88 return null; 

89 } 



90 } 



